\doxysection{v\+Task\+Priority\+Set }
\hypertarget{group__v_task_priority_set}{}\label{group__v_task_priority_set}\index{vTaskPrioritySet@{vTaskPrioritySet}}
task. h 
\begin{DoxyPre}void vTaskPrioritySet( TaskHandle\_t xTask, UBaseType\_t uxNewPriority );\end{DoxyPre}


INCLUDE\+\_\+v\+Task\+Priority\+Set must be defined as 1 for this function to be available. See the configuration section for more information.

Set the priority of any task.

A context switch will occur before the function returns if the priority being set is higher than the currently executing task.


\begin{DoxyParams}{Parameters}
{\em x\+Task} & Handle to the task for which the priority is being set. Passing a NULL handle results in the priority of the calling task being set.\\
\hline
{\em ux\+New\+Priority} & The priority to which the task will be set.\\
\hline
\end{DoxyParams}
Example usage\+: 
\begin{DoxyPre}
void vAFunction( void )
\{
TaskHandle\_t xHandle;

    // Create a task, storing the handle.
    xTaskCreate( vTaskCode, "{}NAME"{}, STACK\_SIZE, NULL, tskIDLE\_PRIORITY, \&xHandle );

    // ...

    // Use the handle to raise the priority of the created task.
    vTaskPrioritySet( xHandle, tskIDLE\_PRIORITY + 1 );

    // ...

    // Use a NULL handle to raise our priority to the same value.
    vTaskPrioritySet( NULL, tskIDLE\_PRIORITY + 1 );
\}
  \end{DoxyPre}
 